package com.bing.config;

/**
 * swagger2生成Restful Api接口文档
 *
 * @author 毛尚俊
 * @create 2017-10-14 14:29
 */

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@EnableSwagger2
@Configuration
public class Swagger2Config {

  @Bean
  public Docket createRestApi() {
    return new Docket(DocumentationType.SWAGGER_2)
        .apiInfo(apiInfo())
        .select() //为当前包路径
        .apis(RequestHandlerSelectors.basePackage("com.bing.controller"))
        .paths(PathSelectors.any()).build();
  }

  //构建 api文档的详细信息函数
  private ApiInfo apiInfo() {
    return new ApiInfoBuilder() //页面标题
        .title("Spring Boot 测试使用 Swagger2 构建RESTful API")
        .termsOfServiceUrl("http://localhost/")
        //创建人
        .contact("Avan")
        //版本号
        .version("1.0")
        //描述
        .description("API 描述")
        .build();
  }
}


